Skip to content

Conversation

@BillWagner
Copy link
Member

Update a variety of TOC nodes to remove parent nodes with both content and children.

This is trying an experiment in the framework to see if it provides a better navigation experience.

@BillWagner BillWagner added this to the May 2019 milestone May 7, 2019
@BillWagner BillWagner force-pushed the remove-link-farms branch from 6a18457 to 4f36614 Compare May 8, 2019 19:32
@BillWagner BillWagner changed the title [WIP] Toc updates for accessibility Toc updates for accessibility, part 1 May 9, 2019
@BillWagner BillWagner requested review from mairaw and rpetrusha May 9, 2019 01:38
@BillWagner
Copy link
Member Author

This ended up bigger than I thought it would be. (The LINQ section had a lot more updates than I expected). Here's a summary of the kinds of changes made:

  1. Many of the "parent" toc nodes with children were portal pages, without much usable content. Those were removed and the content redirected to the first child, or occasionally the parent.
  2. Some parent toc nodes provides a good overview or introductory topic to the section. In those cases, the TOC was updated to add a new TOC text and make the node a child node.
  3. Some child sections had a small set of nodes. Those children were promoted up one level.

To clean links, when a child node had a single "see also" link to the parent, that link was removed.

@BillWagner BillWagner self-assigned this May 9, 2019
@BillWagner BillWagner force-pushed the remove-link-farms branch 3 times, most recently from bc9eda1 to b122555 Compare May 20, 2019 14:57
@BillWagner BillWagner force-pushed the remove-link-farms branch from b122555 to 5563db9 Compare May 20, 2019 15:48
Copy link
Contributor

@mairaw mairaw left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I've reviewed up to advanced-linq-to-xml-programming.md. Looking good so far @BillWagner. Submitting my comments so far while I grab something to eat and then I'll go back to this.

BillWagner and others added 8 commits May 28, 2019 17:45
Where the index.md file in a folder was an overview, or similar, updates the TOC to provide a child node.
The keywords section of the language reference had several pages that were links, but no real content. Re-route those.
This one one got away from me a bit.
These updates respond to the first set of reviews.
@BillWagner BillWagner force-pushed the remove-link-farms branch from a89f965 to 9863342 Compare May 28, 2019 21:45
BillWagner added a commit to BillWagner/docs that referenced this pull request May 28, 2019
Split from dotnet#12244

This covers the area under csharp/language-reference
BillWagner added a commit to BillWagner/docs that referenced this pull request May 28, 2019
Split from dotnet#12244

This covers the area under csharp/language-reference
BillWagner added a commit to BillWagner/docs that referenced this pull request May 29, 2019
Extracted from dotnet#12244

Remove a few areas in the TOC that are already redirectied.
BillWagner added a commit to BillWagner/docs that referenced this pull request May 29, 2019
Extracted from dotnet#12244

This PR has the changes from the language-reference/keywords folder.
BillWagner added a commit that referenced this pull request May 31, 2019
* Remove portal pages from keywords section

Extracted from #12244

This PR has the changes from the language-reference/keywords folder.

* remove portal files.

* fix links to removed files.

* respond to feedback.
@BillWagner
Copy link
Member Author

This was broken into several PRs, and each of those has been merged. Closing.

@BillWagner BillWagner closed this Jun 4, 2019
@BillWagner BillWagner deleted the remove-link-farms branch June 4, 2019 12:21
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants